home *** CD-ROM | disk | FTP | other *** search
/ PC-SIG: World of Utilities / PC-SIG's World of Utilities (PC-SIG) (1994).iso / UTI / DISK0874.ZIP / MANUAL < prev    next >
Text File  |  1987-08-04  |  38KB  |  1,453 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.      ZZAP (c) 1987 David K. Lovison    1                           WESTCOMP
  70.  
  71.  
  72.                   ZZAP IS COPYRIGHT (c) 1987 DAVID K. LOVISON
  73.                               ALL RIGHTS RESERVED
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.      (References to ZZAP include ZZAPA).
  81.  
  82.      You  may  make  archival copies of ZZAP, ZZAPA and MANUAL programs for
  83.      yourself only!  The low price of these programs is an incentive to pay
  84.      WESTCOMP for this software in  exchange  for  hassle-free  unprotected
  85.      software.  Such a program can only survive if everyone pays their full
  86.      share.   If  this  software is to be used at a facility with more than
  87.      one computer, please send a simple letter to WESTCOMP telling  us  the
  88.      company  and  number  of units this package will be used on.  You will
  89.      find our payment request will be very satisfactory in return for  your
  90.      honesty.
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.      ZZAP (c) 1987 David K. Lovison    2                           WESTCOMP
  136.  
  137.  
  138.                        T A B L E   O F   C O N T E N T S
  139.  
  140.  
  141.  
  142.          CHAPTER      SUBJECT                                        PAGE
  143.          _______      ______________________________________________ ____
  144.  
  145.              1.0 .... SELECTING OPTIONS AND CHANGING FIELDS ........   3
  146.  
  147.              2.0 .... ENTRY - TOP LEVEL ............................   5
  148.  
  149.              3.0 .... BUFFER OPERATIONS ............................   6
  150.  
  151.              4.0 .... CHANGING WINDOW VIEW BUFFERS .................   9
  152.  
  153.              5.0 .... EDITING IN A WINDOW VIEW .....................  10
  154.  
  155.              6.0 .... PAGE OPERATIONS ..............................  11
  156.  
  157.              7.0 .... DISK INPUT TO A WINDOW VIEW ..................  15
  158.  
  159.              8.0 .... OPEN A WINDOW VIEW ...........................  17
  160.  
  161.              9.0 .... DISK OUTPUT FROM A WINDOW VIEW ...............  18
  162.  
  163.             10.0 .... WINDOW VIEW BUFFER <-> MEMORY TRANSFERS ......  20
  164.  
  165.             11.0 .... LEAVING ZZAP .................................  21
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.      ZZAP (c) 1987 David K. Lovison    3                           WESTCOMP
  202.  
  203.  
  204.      1.0 .... SELECTING OPTIONS AND CHANGING FIELDS
  205.  
  206.      There are three (3) main ways to select options within ZZAP:
  207.  
  208.               1 - SELECTION FROM A WINDOW MENU,
  209.  
  210.               2 - SELECTION BY USING THE SPACE BAR and
  211.  
  212.               3 - SELECTION BY ALPHA/NUMERIC INPUT.
  213.  
  214.      1.1 .... SELECTION FROM A WINDOW MENU
  215.  
  216.      If more than one (1) choice for an option appears within the bounds of
  217.      a  window  boarder  that  suddenly appears, this is a selection from a
  218.      window menu.
  219.        An example of this would be the options that appear at the top level
  220.      of ZZAP after the space bar has been depressed.  (Run  ZZAP  (or  ZZAP
  221.      B),  then  depress the space bar).  When a window with options appear,
  222.      selection may be made by:
  223.  
  224.                         DEPRESSING THE FIRST LETTER OF THE OPTION
  225.  
  226.                                            or
  227.  
  228.                         MOVE THE SELECTION BAR WITH THE SPACE BAR
  229.                      OR CURSOR ARROW KEYS THEN DEPRESS THE ENTER KEY.
  230.  
  231.      If you change your mind, you may depress the 'ESC' key and  return  to
  232.      the  top  level  of ZZAP.  There are numerous windows of this type and
  233.      they vary in size from that of the  major  options  to  just  two  (2)
  234.      options  in  size.   They all will use the same method of selection or
  235.      abort.  There is one window that appears that may look like  a  window
  236.      menu  but it is not.  This is seen when you select the PAGE OPERATIONS
  237.      option.  This option has it's  own  window  and  options  within  that
  238.      window  but  changing  those options are different than a window menu.
  239.      As actual parameters to be changed, they are altered by ways that  are
  240.      covered in 1.2 and 1.3 (see also 6.0 .... PAGE OPERATIONS).
  241.  
  242.  
  243.  
  244.      1.2 .... SELECTION BY USING THE SPACE BAR
  245.  
  246.      Some  operations  (in  PAGE OPERATIONS) are changed only by depressing
  247.      the space bar.  These are limited to parameters that  have  a  limited
  248.      selection  of  options  such  as the printer (ON / OFF) or the display
  249.      mode (HEX / ASC / DEC / OCT).  If you are depressing the space bar and
  250.      you pass the selection you wanted, just depress the  space  bar  again
  251.      until it re-appears.  The options are displayed in a looping fashion.
  252.  
  253.  
  254.  
  255.      1.3 .... SELECTION BY ALPHA/NUMERIC INPUT
  256.  
  257.      Throughout the ZZAP program, numerous numeric and alpha fields will be
  258.      displayed  in  reverse video or normal video.  Some requests for input
  259.      will prompt you without showing a preselected field.
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.      ZZAP (c) 1987 David K. Lovison    4                           WESTCOMP
  268.  
  269.  
  270.      If there is no preselected field and you depress the enter key without
  271.      any other input, this will usually be  interpreted  as  a  request  to
  272.      abort whatever you are into.
  273.  
  274.      If  there  is  a  preselected  field  that is seen (usually in reverse
  275.      video) you may use the  'DEL'  key  to  completely  erase  it  or  the
  276.      backspace key to remove a charactor at a time.
  277.  
  278.      If  the  field is numeric, your keystrokes are checked for the type of
  279.      numeric field being input.  For example, if the field  is  octal,  you
  280.      will not be able to enter an 8 or 9 or any other charactor that is not
  281.      within the family of octal numbers.
  282.  
  283.      Alpha  fields will only accept alpha charactors (such as the ABS DRIVE
  284.      in the PAGE OPERATIONS mode).  Alpha numeric fields can  contain  most
  285.      anything.   It  does not mean that it is a valid field, however.  Such
  286.      is the case of the file path/name.  The validity is not checked  until
  287.      you  actually  do a read or write.  The same is true of the ABS DRIVE.
  288.      Any letter is allowed for it so  be  sure  you  have  the  drive  that
  289.      matches the letter!
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.      ZZAP (c) 1987 David K. Lovison    5                           WESTCOMP
  334.  
  335.  
  336.      2.0 .... ENTRY - TOP LEVEL
  337.  
  338.      When you first run the ZZAP program, one large window fills the screen
  339.      and  a  smaller  window  will be on the right hand side (the interface
  340.      window).  This is the top level of ZZAP.  The interface window is used
  341.      throughout ZZAP as an  area  to  prompt  you  for  input  as  well  as
  342.      displaying  some information relative to the options you are currently
  343.      in.
  344.  
  345.      Note on the bottom a "status line".  On entry, it shows:
  346.  
  347.      GM: OFF / BUF: BUF / SEG: 0x.... /
  348.  
  349.      This says that the graphics mode is off, the window view buffer is set
  350.      to the internal buffer.  Because the window view buffer is set to  the
  351.      internal buffer, there is no memory segment address specified.
  352.  
  353.      The following keys are used at the top level:
  354.  
  355.  
  356.           KEY    PURPOSE
  357.          _____   ________________________________________________________________
  358.  
  359.          SPACE   DISPLAYS OPTIONS (IF ALREADY DISPLAYED, MOVES SELECTION BAR)
  360.           ESC    IF OPTIONS DISPLAYED, REMOVES THE OPTION WINDOW, ELSE
  361.                  IF A WINDOW VIEW IS ACTIVE, CLOSES THAT WINDOW VIEW
  362.            B     BUFFER OPERATIONS
  363.            C     CHANGE BUFFER (TOGGLE BETWEEN BUFFER/MEMORY)
  364.            E     EDIT THE BUFFER (THE CURRENT WINDOW VIEW)
  365.            P     PAGE OPERATIONS
  366.            R     READ INTO THE BUFFER
  367.            V     VIEW A WINDOW
  368.            W     WRITE FROM THE BUFFER
  369.            M     MOVE BUFFER <-> MEMORY
  370.            Z     ZZAP EXIT
  371.           F1     IF LEFT WINDOW IS UP AND NOT CURRENT, MAKES IT THE CURRENT ONE
  372.           F2     IF RIGHT WINDOW IS UP AND NOT CURRENT, MAKES IT THE CURRENT ONE
  373.          ALT-G   TOGGLE BETWEEN GRAPHIC MODE ON / OFF
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.      ZZAP (c) 1987 David K. Lovison    6                           WESTCOMP
  400.  
  401.  
  402.      3.0 .... BUFFER OPERATIONS
  403.  
  404.      This  operation allows you to perform various operations to the window
  405.      view buffer (or  whatever  the  window  view  is  accessing).   It  is
  406.      necessary  for a window view to be active in order to use this option.
  407.      If no window view is up,
  408.       one will be opened for you.  After  selecting  this  option,  another
  409.      window with
  410.       options will be displayed.  Select from:
  411.  
  412.                         1 - ADVANCE
  413.                         2 - COPY
  414.                         3 - EXCHANGE
  415.                         4 - FILL
  416.                         5 - SCAN
  417.                         6 - MATCH
  418.                         7 - NEW MODE
  419.                         8 - LOGICALS
  420.  
  421.  
  422.      3.1 .... ADVANCE
  423.  
  424.      This  allows  you to move the specified byte (0 - 65535) to the top of
  425.      the active window view.  After the prompt  "ADVANCE  TO:",  input  the
  426.      number  of  the byte to move to in decimal.  After you input a number,
  427.      that byte will now be at the top  of  the  active  window  view.   The
  428.      window view will loop back to the beginning
  429.       (byte 0) if the display reaches the end (byte 65535) first.
  430.  
  431.  
  432.      3.2 .... COPY
  433.  
  434.      This  allows  you  to  copy  a range of bytes from one area to another
  435.      within the current window view.  You  will  be  asked  for  three  (3)
  436.      parameters:
  437.  
  438.               PROMPT         INPUT
  439.               __________     _____________________________________________________
  440.  
  441.               SOURCE:        THE BYTE # (DEC) OF THE STARTING STRING TO COPY
  442.               DESTIN:        THE BYTE # (DEC) TO BEGIN TRANSFERING TO
  443.                COUNT:        THE NUMBER OF BYTES TO COPY (UP TO 65535)
  444.  
  445.  
  446.  
  447.      3.3 .... EXCHANGE
  448.  
  449.      This  allows  you to exchange a range of bytes with one another within
  450.      the current window view.  Again, you  will  be  asked  for  three  (3)
  451.      parameters:
  452.  
  453.               PROMPT         INPUT
  454.               __________     ____________________________________________________
  455.  
  456.               SOURCE:        THE BYTE # (DEC) OF THE STARTING STRING TO EXCHANGE
  457.               DESTIN:        THE BYTE # (DEC) TO BEGIN THE EXCHANGE WITH
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.      ZZAP (c) 1987 David K. Lovison    7                           WESTCOMP
  466.  
  467.  
  468.                COUNT:        THE NUMBER OF BYTES TO EXCHANGE (UP TO 65535)
  469.  
  470.  
  471.  
  472.      3.4 .... FILL
  473.  
  474.      This allows you to fill the current window view buffer with a selected
  475.      byte.  The three (3) parameters to answer are:
  476.  
  477.               PROMPT         INPUT
  478.               __________     ____________________________________________________
  479.  
  480.               START BYTE:    THE BYTE # (DEC) TO BEGIN THE FILL
  481.               # OF BYTES:    THE NUMBER OF BYTES YOU WANT TO FILL
  482.                FILL WITH:    INPUT DEPENDS ON THE CURRENT MODE FOR THAT WINDOW
  483.  
  484.      When  ZZAP  is  first  entered, both windows are set to an ASCii mode.
  485.      The mode is seen at the top of the window  view  itself  -  it  is  in
  486.      normal video while the other options are in the same video mode as the
  487.      window border itself.  See 3.7 on changing this mode.
  488.  
  489.  
  490.      3.5 .... SCAN
  491.  
  492.      This  allows  you  to  scan  the  current window view up or down.  The
  493.      buffer will loop around if one of the limits are reached (0 or 65535).
  494.      There are no prompts
  495.       but you can use the up arrow and down arrow cursor  keys  to  control
  496.      the  direction  of  the  scan.   You  can use the left and right arrow
  497.      cursor keys to control the scanning speed.  The left arrow speeds  the
  498.      scan.   This  throttle  was  used  to  adjust the speed because of the
  499.      variety of systems and their  various  clock  speeds.   Some  systems,
  500.      without  the  throttle,  will scan so fast that nothing is readable at
  501.      all - just a blurrrrrr!  While you are scanning,  you  may  pause  the
  502.      display  by  pressing  the space bar.  Any other key will continue the
  503.      scan.  To exit the scan mode, depress the 'END' key.
  504.  
  505.  
  506.      3.6 .... MATCH
  507.  
  508.      This allows a string to be searched for  within  a  window  view  (the
  509.      destination
  510.       window).   A  window  menu  will  appear  twice to prompt you for the
  511.      source and destination windows.  The window  view  for  the  source  /
  512.      destination  must  be open yet not necessarily active.  The source and
  513.      destination window views can be the same window.  After  selection  of
  514.      the source and destination, the following parameters must be answered:
  515.  
  516.               PROMPT         INPUT
  517.               __________     ____________________________________________________
  518.  
  519.               MATCH BYTE:    BYTE # OF START OF STRING IN SOURCE WINDOW (DEC)
  520.               # OF BYTES:    # OF BYTES IN THE STRING TO SEARCH FOR
  521.             START SEARCH
  522.                FROM BYTE:    BYTE # IN DESTINATION WINDOW TO BEGIN THE SEARCH
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.      ZZAP (c) 1987 David K. Lovison    8                           WESTCOMP
  532.  
  533.  
  534.      If  no  match  is  found,  a  message is printed to state such and the
  535.      program will pause until a key is pressed.
  536.  
  537.      If a match is found, a beep will occur and the destination window  top
  538.      byte is set to the 1st byte of the matched string.  If the destination
  539.      window  is also set as the current window, the window will be updated.
  540.      If the destination window is not the current window, you will not  see
  541.      the update until you make it the current window with the F1/F2 keys at
  542.      the top level.
  543.  
  544.  
  545.      3.7 .... NEW MODE
  546.  
  547.      This  is where you select the mode (ASC, DEC, OCT, HEX) to use for the
  548.      current window.  Another window of options will be displayed with  the
  549.      four  (4)  options.   Simply  select  the  new  option  and  the  mode
  550.      indication on top of the current window will be changed!
  551.  
  552.  
  553.      3.8 .... LOGICALS
  554.  
  555.      You can perform logical operations to a  range  of  bytes  within  the
  556.      current  window  view.   Upon selection of this option, another window
  557.      menu will appear.  Select the logical operation to be performed  (AND,
  558.      OR,  XOR,  RSH,  LSH,  CMP).   The  CMP  is a one's compliment.  After
  559.      selection of the operation, answer the following prompts:
  560.  
  561.               PROMPT         INPUT
  562.               __________     ____________________________________________________
  563.  
  564.               START BYTE:    STARTING BYTE # TO PERFORM OPERATION
  565.               # OF BYTES:    NUMBER OF BYTES TO DO (UP TO 65535)
  566.             LOGICAL BYTE:    BYTE (HEX) TO PERFORM LOGICAL OPERATION WITH
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.      ZZAP (c) 1987 David K. Lovison    9                           WESTCOMP
  598.  
  599.  
  600.      4.0 .... CHANGING WINDOW VIEW BUFFERS
  601.  
  602.      This option will toggle between the internal window view buffer and  a
  603.      specified memory segment.  If a window view is current (high-lighted),
  604.      that  window view will be toggled also.  If the current window view is
  605.      pointing to the internal buffer and  this  option  is  selected,  that
  606.      window  will  now  change to whatever segment in memory specified.  If
  607.      this option is selected again, the window will once again be  back  to
  608.      the  internal  buffer  (no  data is altered by using this mode).  Note
  609.      that a window view does not need to be opened  for  this  option.   If
  610.      this  option  is  selected,  the next window view to be opened will be
  611.      opened into whatever is shown at the bottom status line:  BUF:  xxx  /
  612.      SEG: 0x....
  613.  
  614.      When  going  from  the  buffer to memory, you will be prompted for the
  615.      memory segment (HEX) to use as the new "buffer".  When switching  back
  616.      and  forth between left and right window views, the bottom status line
  617.      will display what that window view is pointing to.
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.      ZZAP (c) 1987 David K. Lovison    10                          WESTCOMP
  664.  
  665.  
  666.      5.0 .... EDITING IN A WINDOW VIEW
  667.  
  668.      You may edit the current window view a byte at a time in  the  current
  669.      mode  for  that window (HEX, DEC, OCT, ASC).  You will be prompted for
  670.      "EDIT BYTE:".  This is the starting byte (in DEC) to begin to edit.  A
  671.      reverse video bar will be displayed over the first byte to edit.
  672.  
  673.      Use the up arrow and down arrow cursor  keys  to  move  the  edit  bar
  674.      before
  675.       you input the next byte.
  676.  
  677.      If the current mode is ASC, you may type freely until you depress ALT-
  678.      Q.   This  will  terminate  the  edit session is the mode was ASC.  To
  679.      terminate the edit session in a numeric mode, just depress the "ENTER"
  680.      key (no input).
  681.  
  682.      Upon termination, the edit bar will leave and you will be returned  to
  683.      the top level of ZZAP.
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.      ZZAP (c) 1987 David K. Lovison    11                          WESTCOMP
  730.  
  731.  
  732.      6.0 .... PAGE OPERATIONS
  733.  
  734.      Page operations allows you to view data in one of four modes that will
  735.      fill the screen (256 bytes at a time).  Upon selection of this option,
  736.      you will see the page set-up screen.  These are parameters that may be
  737.      changed to suit your individual need.  They are:
  738.  
  739.                    1 - PRINTER                     9 - FILE END
  740.                    2 - PAGE LENGTH                10 - SECTOR START
  741.                    3 - LEFT MARGIN                11 - SECTOR END
  742.                    4 - PERF SKIP                  12 - ABS DRIVE
  743.                    5 - FILE NAME                  13 - ACCESS MODE
  744.                    6 - BUFFER START               14 - SHOW BYTE CNT
  745.                    7 - BUFFER END                 15 - DISPLAY MODE
  746.                    8 - FILE START                 16 - FILE DUMP
  747.  
  748.      To  select  a  parameter to change, move the selection bar with the up
  749.      and down arrow keys.
  750.  
  751.  
  752.      6.1 .... PRINTER
  753.  
  754.      Allows the output to be sent to the  printer.   Selection  is  toggled
  755.      with the space bar - ON / OFF.
  756.  
  757.  
  758.      6.2 .... PAGE LENGTH
  759.  
  760.      Allows  setting  the  number  of  printed  lines  (data only, does not
  761.      include the title line) for output to the printer.  To change, depress
  762.      the space bar and change the numeric field.  Depress the  "ENTER"  key
  763.      when  you  are finished.  When the page length is met, the page number
  764.      is incremented (lines are counted even when scrolling up and down).
  765.  
  766.  
  767.      6.3 .... LEFT MARGIN
  768.  
  769.      Allows a left margin to be printed before each line is printed to  the
  770.      printer.
  771.        This  just allows for neater outputs from the printer.  Edit of this
  772.      field is done as in 6.2.
  773.  
  774.  
  775.      6.4 .... PERF SKIP
  776.  
  777.      When the printer is ON and the number of lines printed match the  page
  778.      length,
  779.       blank lines will be output (to skip over fan fold paper perfs).  Edit
  780.      of this field is done as in 6.2.
  781.  
  782.  
  783.      6.5 .... FILE NAME
  784.  
  785.      The  file  name  (which  can  include  a  drive/path)  can be up to 50
  786.      charactors in length.  This file name is shared by the  READ  /  WRITE
  787.      operations  to  the  window view modes.  Edit of this field is done as
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.      ZZAP (c) 1987 David K. Lovison    12                          WESTCOMP
  796.  
  797.  
  798.      mentioned in chapter 1.0.
  799.  
  800.  
  801.      6.6 .... BUFFER START
  802.  
  803.      The starting byte (DEC) to start the page display in.  When  you  edit
  804.      this  value, you can not make it greater than the buffer end byte.  If
  805.      you need to,
  806.       change the buffer end byte value first.  Edit of this field  is  done
  807.      as in 6.2.
  808.  
  809.  
  810.      6.7 .... BUFFER END
  811.  
  812.      The  ending byte (DEC) to end the page display in.  When you edit this
  813.      value,
  814.       you can not make it less than that of the buffer start byte.  If  you
  815.      need to,
  816.       change  the  buffer start value first.  Edit of this field is done as
  817.      in 6.2.
  818.  
  819.  
  820.      6.8 .... FILE START
  821.  
  822.      File start values always begin with 1.  You can not make this any less
  823.      than 1 nor can you make it greater than the file  end  byte.   If  you
  824.      need  to,  change  the  file  end  value first.  If the start value is
  825.      greater than the end of the file (the file  size),  you  will  get  an
  826.      error.  Edit of this field is done as in 6.2.
  827.  
  828.  
  829.      6.9 .... FILE END
  830.  
  831.      The  file end value can not be less than that of the file start value.
  832.      It can exceed the end of the file.  If it  does,  the  value  will  be
  833.      readjusted to a
  834.       value  that  will  not exceed the file end as well as exceed the page
  835.      buffer (one segment in size) that is used for disk  input,  both  file
  836.      and sector
  837.       operations.  Edit of this field is done as in 6.2.
  838.  
  839.  
  840.      6.10 .... SECTOR START
  841.  
  842.      The  sector  start can range up to and including the sector end value.
  843.      If both sector start and end are the same, only that  sector  is  read
  844.      in.   Edit  of  this  field  is  done  as in 6.2.  Sectors are logical
  845.      sectors numbered from 0.
  846.  
  847.  
  848.      6.11 .... SECTOR END
  849.  
  850.      This value can not go below the sector  start  value.   Edit  of  this
  851.      field is done as in 6.2.
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.      ZZAP (c) 1987 David K. Lovison    13                          WESTCOMP
  862.  
  863.  
  864.      6.12 .... ABS DRIVE
  865.  
  866.      This  is the drive letter used for absolute (sector) operations.  This
  867.      drive is the same as used for sector READ / WRITE  operations  to  the
  868.      window view.  To
  869.       edit  the drive, depress the space bar, depress the backspace key and
  870.      enter a drive.  If you don't enter anything, you will get  an  invalid
  871.      drive error.
  872.  
  873.  
  874.      6.13 .... ACCESS MODE
  875.  
  876.      This  is  what  the  page  mode will actually display.  Depressing the
  877.      space bar
  878.       will cycle through the options of BUFFER, FILE, SECTOR.  If  file  or
  879.      sector have been selected, the disk and file / sector will be accessed
  880.      and  the data will be read into the dedicated file buffer (the address
  881.      of this file buffer appears at the bottom right hand side of the  page
  882.      options  screen.   You  can use this segment with the window view thus
  883.      providing a way to write back to the disk.  The  BUFFER  selection  is
  884.      the  current  window  view buffer, whether that be the internal window
  885.      view buffer or a memory segment specified with the 'c' mode option  at
  886.      the top level of ZZAP.
  887.  
  888.  
  889.      6.14 .... SHOW BYTE CNT
  890.  
  891.      Depressing  the  space  bar will toggle this selection between HEX and
  892.      DEC.  The values on the right-hand side of the page display as well as
  893.      the start and end bytes will be displayed in whatever mode this option
  894.      is in.  If the ACCESS MODE has been set to SECTOR, the byte  count  is
  895.      always changed to HEX to show both the sector and byte of that sector.
  896.  
  897.  
  898.      6.15 .... DISPLAY MODE
  899.  
  900.      The actual display of data in page mode will be in this mode.  Depress
  901.      the space bar to cycle through the options (DEC, HEX, OCT, ASC).  When
  902.      the  HEX  mode  is selected, the display is both HEX and ASC, with the
  903.      ASC showing only printable charactors.  Any other charactors  will  be
  904.      displayed by a period.
  905.  
  906.  
  907.      6.16 .... FILE DUMP
  908.  
  909.      This  allows  you  to dump a file from the start byte specified to the
  910.      end of the file.  The file end value will be reset to read in  a  full
  911.      segment  worth  of  data until the end of file is reached.  The ACCESS
  912.      MODE must be set to FILE.
  913.        When the dump begins, it will stop when it reaches the  end  of  the
  914.      file  or when a key is depressed.  This means you can dump those large
  915.      files to a printer and walk away until it is done!
  916.  
  917.  
  918.      To leave the page options and display the data, just depress the 'END'
  919.      key.
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.      ZZAP (c) 1987 David K. Lovison    14                          WESTCOMP
  928.  
  929.  
  930.      To return to the top level, depress the 'ESC' key.
  931.  
  932.      While in the page display, the following keys may be used  (except  if
  933.      doing a file dump):
  934.  
  935.          KEY      PURPOSE
  936.       _________   ________________________________________________________________
  937.  
  938.       DN ARROW    SCROLL THE DATA DOWN UNTIL THE END LIMIT IS REACHED
  939.       UP ARROW    SCROLL THE DATA UP UNTIL THE END LIMIT IS REACHED
  940.         PGDN      SCROLL THE DATA DOWN 1 PAGE WORTH
  941.         PGUP      SCROLL THE DATA UP 1 PAGE WORTH
  942.         HOME      START THE DISPLAY FROM THE STARTING BYTE
  943.         END       START THE DISPLAY TO INCLUDE THE END BYTE
  944.        ALT-G      TOGGLE THE GRAPHIC MODE DISPLAY
  945.        ALT-Q      TOGGLE THE EDIT MODE
  946.        ALT-A      WHEN IN HEX DISPLAY MODE AND IN EDIT MODE, TOGGLE TO/FROM ASCII
  947.       LT ARROW    SPEED THE DISPLAY UP (SAME AS THROTTLE IN BUFFER SCAN MODE)
  948.       RT ARROW    SLOW THE DISPLAY DOWN (SAME AS THROTTEL IN BUFFER SCAN MODE)
  949.         ESC       RETURN BACK TO THE PAGE OPTIONS
  950.  
  951.      When  in  the edit mode, use the cursor arrow keys to move the cursor.
  952.      Edit mode will edit only the data that is displayed at that  point  in
  953.      time!
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.      ZZAP (c) 1987 David K. Lovison    15                          WESTCOMP
  994.  
  995.  
  996.      7.0 .... DISK INPUT TO A WINDOW VIEW
  997.  
  998.      You  may  read  file or sector data into the current window view.  Pay
  999.      attention to what the current window view  is  pointing  to!   If  the
  1000.      drive  you are using is a removeable media drive, be sure the media is
  1001.      in first!
  1002.  
  1003.      NOTE:  ZZAP RETAINED THE FATAL ERROR HANDLER OF MS-DOS.  IF A FATAL ERROR
  1004.             DOES OCCUR, ATTEMPT TO CORRECT THE PROBLEM (UNLESS YOU WANT TO ABORT)
  1005.             AND RETRY THE OPERATION.  THE WORST CASE RESULT IS THAT SMALL PORTIONS
  1006.             OF THE SCREEN WILL RETAIN THE CHARACTORS THAT WERE PRINTED BY THE
  1007.             FATAL ERROR ROUTINE.  IT WAS DECIDED THAT IF THE ERROR WAS FATAL IN
  1008.             NATURE, WE WANTED ZZAP TO RETURN TO THE OPERATING SYSTEM IN CASE OF
  1009.             AN EMERGENCY ABORT.
  1010.  
  1011.  
  1012.      Upon selection of this option, you will  be  prompted  with  a  window
  1013.      menu:
  1014.  
  1015.                    1 - FILE ACCESS
  1016.                    2 - SECTOR ACCESS
  1017.  
  1018.      7.1 .... FILE ACCESS
  1019.  
  1020.      DO  NOT  REMOVE  YOUR DISK MEDIA UNTIL THE PROGRAM HAS RETURNED TO THE
  1021.      TOP LEVEL!
  1022.  
  1023.      In this mode, if you specify a file name that  does  not  exists,  one
  1024.      will be created with a length of 0.
  1025.  
  1026.      You  will  be  shown  the  drive/path/filename  (same  one  as in PAGE
  1027.      OPERATIONS) and be given an opportunity to change it.
  1028.  
  1029.      After depressing the "ENTER" key, the file will be  accessed  and  the
  1030.      size of file will be displayed.
  1031.  
  1032.               PROMPT         INPUT
  1033.               __________     ____________________________________________________
  1034.  
  1035.               FILE ST:       >= 1, 0 WILL ABORT, ERROR IF > SIZE OF FILE
  1036.               XFER CT:       NUMBER OF BYTES TO TRANSFER TO THE CURRENT WINDOW
  1037.               BUFF ST:       STARTING BYTE OF BUFFER TO BEGIN THE TRANSFER
  1038.  
  1039.  
  1040.      An  error  will result if the XFER CT plus the BUFF ST exceeds the end
  1041.      of the window view buffer (65535).  The  maximum  bytes  that  can  be
  1042.      transfered  is 65536 when BUFF ST = 0.  If the XFER CT is greater than
  1043.      the end of the file, XFER CT is changed to the end of  the  file  (the
  1044.      file size).
  1045.  
  1046.      After entering the above, "<R>ead" will appear.  You must enter an 'r'
  1047.      or  'R' to begin the read operation.  After the read is done, you will
  1048.      be told the number of bytes that actually  transfered  and  ZZAP  will
  1049.      pause until you depress a key.
  1050.  
  1051.      The current window is updated upon return to the top level.
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.      ZZAP (c) 1987 David K. Lovison    16                          WESTCOMP
  1060.  
  1061.  
  1062.      7.2 .... SECTOR ACCESS
  1063.  
  1064.      You will be shown the drive (change it in the PAGE OPERATIONS options)
  1065.      and be prompted for:
  1066.  
  1067.               PROMPT         INPUT
  1068.               __________
  1069.      ____________________________________________________
  1070.  
  1071.               START @:       STARTING SECTOR (DEC)
  1072.               XFER CT:       # OF SECTORS TO READ IN (0 WILL ABORT)
  1073.               BUFF ST:       STARTING BYTE IN BUFFER TO START TRANSFER
  1074.  
  1075.  
  1076.      You will be shown the bytes/sector and then "<R>ead" will appear.  You
  1077.      must  depress  either  'r' or 'R' to initiate the read operation.  Any
  1078.      other key will abort this option.  As the sectors are reading in,  you
  1079.      will  see the count of that sector displayed (if the number of sectors
  1080.      are small, this might occur to fast to see).  The current window  view
  1081.      will be updated when this is done!
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.      ZZAP (c) 1987 David K. Lovison    17                          WESTCOMP
  1126.  
  1127.  
  1128.      8.0 .... OPEN A WINDOW VIEW
  1129.  
  1130.      Two  window  views can be opened at any one time.  Only one of the two
  1131.      may be active.  The active window is the  one  with  the  high-lighted
  1132.      window  border.  Remember that you can change the active window at the
  1133.      top level by using the F1 / F2 keys.  If  you  try  to  open  a  third
  1134.      window,  you  will get an error message telling you to remove a window
  1135.      view first.  Remember that the  'ESC'  key  will  delete  the  current
  1136.      (active) window.
  1137.  
  1138.      When  a  window  view  is opened, the mode will be set to whatever was
  1139.      last selected.  What the window view will be a window into depends  on
  1140.      what  the bottom status line is showing.  (BUF: BUF) will set the view
  1141.      to the internal dedicated  window  view  buffer.   (BUF:  MEM  /  SEG:
  1142.      0x????)  will set the view to the segment specified by ????.  Whatever
  1143.      it is a view into, the full range of the window view is 0 - 65535, for
  1144.      a total of 65536 bytes (1 full segment size).
  1145.  
  1146.      Also remember that when the term buffer is used for the access mode in
  1147.      the page operations, it is refering to the  CURRENT  WINDOW  VIEW  and
  1148.      whatever it is viewing.  It could be viewing the dedicated file buffer
  1149.      for the page mode by entering that buffer segment in the 'c' operation
  1150.      (from top level).
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.      ZZAP (c) 1987 David K. Lovison    18                          WESTCOMP
  1192.  
  1193.  
  1194.      9.0 .... DISK OUTPUT FROM A WINDOW VIEW
  1195.  
  1196.      You  may  write file or sector data into the current window view.  Pay
  1197.      attention to what the current window view  is  pointing  to!   If  the
  1198.      drive  you are using is a removeable media drive, be sure the media is
  1199.      in first and NOT write protected!!!
  1200.  
  1201.      NOTE:  ZZAP RETAINED THE FATAL ERROR HANDLER OF MS-DOS.  IF A FATAL ERROR
  1202.             DOES OCCUR, ATTEMPT TO CORRECT THE PROBLEM (UNLESS YOU WANT TO ABORT)
  1203.             AND RETRY THE OPERATION.  THE WORST CASE RESULT IS THAT SMALL PORTIONS
  1204.             OF THE SCREEN WILL RETAIN THE CHARACTORS THAT WERE PRINTED BY THE
  1205.             FATAL ERROR ROUTINE.  IT WAS DECIDED THAT IF THE ERROR WAS FATAL IN
  1206.             NATURE, WE WANTED ZZAP TO RETURN TO THE OPERATING SYSTEM IN CASE OF
  1207.             AN EMERGENCY ABORT.
  1208.  
  1209.  
  1210.      Upon selection of this option, you will  be  prompted  with  a  window
  1211.      menu:
  1212.  
  1213.                    1 - FILE ACCESS
  1214.                    2 - SECTOR ACCESS
  1215.  
  1216.      7.1 .... FILE ACCESS
  1217.  
  1218.      DO  NOT  REMOVE  YOUR DISK MEDIA UNTIL THE PROGRAM HAS RETURNED TO THE
  1219.      TOP LEVEL!
  1220.  
  1221.      You will be  shown  the  drive/path/filename  (same  one  as  in  PAGE
  1222.      OPERATIONS) and be given an opportunity to change it.
  1223.  
  1224.      After  depressing  the  "ENTER" key, the file will be accessed and the
  1225.      size of file will be displayed.
  1226.  
  1227.               PROMPT         INPUT
  1228.               __________     ____________________________________________________
  1229.  
  1230.               FILE ST:       >= 1, 0 WILL ABORT, ERROR IF > SIZE OF FILE
  1231.               XFER CT:       NUMBER OF BYTES TO TRANSFER TO THE CURRENT WINDOW
  1232.               BUFF ST:       STARTING BYTE OF BUFFER TO BEGIN THE TRANSFER
  1233.  
  1234.  
  1235.      An error will result if the XFER CT plus the BUFF ST exceeds  the  end
  1236.      of  the  window  view  buffer  (65535).  The maximum bytes that can be
  1237.      transfered is 65536 when BUFF ST = 0.  If the XFER CT is greater  than
  1238.      the  end of the file, the size of the file will be increased.  Keep in
  1239.      mind that this is  done  by  stream  operations,  so  any  END-OF-FILE
  1240.      indicator may be overwritten!  If you need a particular indicator, you
  1241.      can  easily  write  that out to the end of the file with ZZAP.  Writes
  1242.      that are less that the size of file will not reduce the  size  of  the
  1243.      file.  The data is "painted" where you want it on the file.
  1244.  
  1245.      After  entering  the  above, "<W>rite" will appear.  You must enter an
  1246.      'w' or 'W' to begin the write operation.  After the write is done, you
  1247.      will be told the number of bytes that  actually  transfered  and  ZZAP
  1248.      will pause until you depress a key.
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.      ZZAP (c) 1987 David K. Lovison    19                          WESTCOMP
  1258.  
  1259.  
  1260.      The current window is updated upon return to the top level.
  1261.  
  1262.  
  1263.      7.2 .... SECTOR ACCESS
  1264.  
  1265.      You will be shown the drive (change it in the PAGE OPERATIONS options)
  1266.      and be prompted for:
  1267.  
  1268.               PROMPT         INPUT
  1269.               __________
  1270.      ____________________________________________________
  1271.  
  1272.               START @:       STARTING SECTOR (DEC)
  1273.               XFER CT:       # OF SECTORS TO WRITE (0 WILL ABORT)
  1274.               BUFF ST:       STARTING BYTE IN BUFFER TO START TRANSFER
  1275.  
  1276.  
  1277.      You  will  be  shown  the bytes/sector and then "<W>rite" will appear.
  1278.      You must depress either 'w' or 'W' to initiate  the  write  operation.
  1279.      Any  other  key  will  abort  this  option.   As the sectors are being
  1280.      written, you will see the count  of  that  sector  displayed  (if  the
  1281.      number  of  sectors  are small, this might occur to fast to see).  The
  1282.      current window view will be updated when this is done!
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.      ZZAP (c) 1987 David K. Lovison    20                          WESTCOMP
  1324.  
  1325.  
  1326.      10.0 .... WINDOW VIEW BUFFER <-> MEMORY TRANSFERS
  1327.  
  1328.      This is to transfer between  the  dedicated  window  view  buffer  and
  1329.      memory.   Upon selection of this option, a window with two (2) options
  1330.      will appear:
  1331.  
  1332.                    1 - MEMORY -> BUFFER
  1333.                    2 - BUFFER -> MEMORY
  1334.  
  1335.      Chose the direction you want the transfer to go.  <M> will move memory
  1336.      into the buffer (the dedicated window view  buffer).   <B>  will  move
  1337.      data in the buffer to the specified memory location.
  1338.  
  1339.      After selection of the direction, answer the following prompts:
  1340.  
  1341.               PROMPT         INPUT
  1342.               __________     ____________________________________________________
  1343.  
  1344.           MEM (HEX) SEG:     INPUT THE MEMORY SEGMENT IN HEX
  1345.                MEM BYTE:     SEGMENT OFFSET (DEC) 0 - 65535
  1346.               BUFFER ST:     STARTING BYTE OF THE DEDICATED WINDOW BUFFER TO XFER
  1347.                 # BYTES:     NUMBER OF BYTES TO TRANSFER
  1348.                              ( IF 0, ABORT)
  1349.                              ( IF BUFFER ST + # BYTES > END OF BUFFER, ERROR)
  1350.                              ( IF NO VALUE ENTERED, ABORT)
  1351.  
  1352.  
  1353.      If  there is a current window up, the top of that window is set to the
  1354.      value entered as the BUFFER ST value and the window is updated (it  is
  1355.      possible  that  the  current  window  is not pointing to the dedicated
  1356.      window buffer, in which case the update would only remind you what the
  1357.      buffer start byte was).
  1358.  
  1359.      It is not required to even have a window view  open  to  perform  this
  1360.      operation,  since  the buffer used is always the dedicated window view
  1361.      buffer.
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.      ZZAP (c) 1987 David K. Lovison    21                          WESTCOMP
  1390.  
  1391.  
  1392.      11.0 .... LEAVING ZZAP
  1393.  
  1394.      It is easy (perhaps too much so) to exit  ZZAP.   Just  depressing  an
  1395.      upper  or lower case Z will return you back to the command line of MS-
  1396.      DOS.  Don't make a practice of leaning your hands or anything else  on
  1397.      the keyboard - you might exit at a time you did not want to!
  1398.  
  1399.      If  you  find  a  change  you would like to see to ZZAP or a bug (hope
  1400.      not!), please let us know by a letter with  the  exact  information  -
  1401.      please  print!   If you are the first to make us aware of a problem or
  1402.      we include an enhancement that you first suggested, we will  send  you
  1403.      the updated version with our thanks!
  1404.  
  1405.      We keep a data base of those that have purchased ZZAP.  This data base
  1406.      will  be  used  to  make  all aware of major changes and how to aquire
  1407.      them.
  1408.  
  1409.      IF YOU PURCHASED ZZAP, THANK YOU.  IF YOU HAVE A  COPY  AND  HAVE  NOT
  1410.      PAID,  PLEASE SEND IN YOUR PAYMENT FOR A MODEST $30.00.  WE AND OTHERS
  1411.      LIKE US CAN ONLY SURVIVE IF  SUCH  QUALITY,  LOW  PRICED  SOFTWARE  IS
  1412.      PROPERLY  PAID FOR.  PROGRAMS THAT DO HALF OF WHAT ZZAP DOES WILL COST
  1413.      YOU MUCH MORE IF PURCHASED IN ONE OF THE NORMAL STORES, ETC.
  1414.  
  1415.      AGAIN, THANKS.
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.